GraphQL ServerのCode frist→ Schema first→ Code firstの遍歴
GraphQLを実装する際の手法に移り変わりがある
第1世代: Code First(graphql-js)
2015~
第2世代: Schema First
2016~
第3世代: Code First
2018~
時期も割と重要mrsekut.icon
例えば、『初めてのGraphQL』の原著の出版は2018/9なので、
Code Firstは誕生しているけど半年ぐらししか経っていない
完全にSchema Firstを前提に書かれている
他の選択肢があるよとも書かれていない(Code Firstという単語は出てこない)
参考
GraphQL Code-First and SDL-First, the Current Landscape in Mid-2019 - DEV Community
The Problems of "Schema-First" GraphQL Server Development | Prisma
第1世代: Code First(graphql-js)
GraphQLがリリースされた2015年辺りの話
GraphQLの仕様と共に、実装としてGraphQL.jsが発表されたが、
このGraphQL.jsが第1世代のCode Firstと呼べるもの
例
code:Js
const schema = new GraphQLSchema({
query: new GraphQLObjectType({
name: 'Query',
fields: {
hello: {
type: GraphQLString,
args: {
name: { type: GraphQLString },
},
resolve: (_, args) => Hello ${args.name || 'World!'},
},
},
}),
})
Schemaの定義を素のJSのobjectで書いている
定義を書くのが冗長で大変
第2世代: Schema First
2016年辺りにApolloがgraphql-toolsをリリース
Schemaの定義と、実装を分離する
第1世代のものが冗長さに比較して、Schemaの定義は簡素
例
code:ts
const typeDefs = `
type Query {
hello(name: String): String
}
`
const resolvers = {
Query: {
hello: (_, args) => Hello ${args.name || 'World!'},
},
}
const schema = makeExecutableSchema({
typeDefs,
resolvers,
})
型とresolverを定義して、Schemaを作る
規模が大きくなってくると大変
ツールを組み合わせることで解決できるが、ツールの数が増えすぎて大変になった
第3世代: Code First
Nexusのinitial commitは2018/11
TypeGraphQLのinitial commitは2018/1
第1世代もCode Firstだが、普通に「Code First」と言ったときは、これを指す
でも現状のGraphQL.jsって第3世代っぽくなってるんじゃないか(よく知らん) #??
Schema Firstでは、問題点の解決の為に、多量のtoolが必要になった
では、元から色々サポートされているプログラミング言語の恩恵を受ければいいじゃない
言語の能力もあるし、IDEのサポートも既にある
という感じでCode Firstが出てきた
Nexusの例
code:ts
const Query = objectType('Query', t => {
t.string('hello', {
args: { name: stringArg() },
resolve: (_, { name }) => Hello ${name || World}!,
})
})
const schema = makeSchema({
types: Query,
outputs: {
schema: './schema.graphql'),
typegen: './typegen.ts',
},
})
TypeGraphQLの例
code:ts
@ObjectType()
class Recipe {
@Field(type => ID)
id: string;
@Field()
title: string;
@Field(type => Rate)
ratings: Rate[];
@Field({ nullable: true })
averageRating?: number;
}
第1世代のCode Firstのように素のJS objectで書くのではなく、言語上のDSLで記述することでより簡潔に書ける